home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / fix402s.zip / FIXMANUL.DOC < prev    next >
Text File  |  1994-04-01  |  41KB  |  990 lines
  1.                                                      fixmanul.doc 4-94
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                                
  9.  
  10.  
  11.                                                
  12.  
  13.  
  14.                                                
  15.  
  16.  
  17.                                                
  18.  
  19.  
  20.                                                
  21.  
  22.  
  23.                                                
  24.  
  25.  
  26.                               FIX 4.02 USER'S MANUAL
  27.  
  28.  
  29.                                     April 1994
  30.  
  31.  
  32.                                                
  33.  
  34.  
  35.                                                
  36.  
  37.  
  38.                                                
  39.  
  40.  
  41.                                                
  42.  
  43.  
  44.                                   NovaLogic(TM)
  45.                                 13585 SW Pommel Ct
  46.                              Beaverton, OR 97005-7231
  47.                                                
  48.                               voice: (503) 524-9184
  49.                          internet: novalogic@teleport.com
  50.                                                
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65. ::
  66.  
  67.                                                
  68.                                                
  69.                                                
  70.                                                
  71.                                        - i -
  72.  
  73.  
  74.                                      CONTENTS
  75.                                                
  76.             Introduction .......................................   1
  77.             
  78.             Uses for FIX .......................................   1
  79.             
  80.             Syntax .............................................   2
  81.             
  82.             Online Help ........................................   2
  83.             
  84.             Specify Strings ....................................   2
  85.             
  86.             Special String Conditions ..........................   3
  87.             
  88.             Specify Input/Output Files .........................   4
  89.             
  90.             Set Alternate Mode of Operation ....................   5
  91.             
  92.             Output .............................................   6
  93.             
  94.             Automatic Protection Re-writing Files ..............   7
  95.             
  96.             Return Code ........................................   9
  97.             
  98.             Requirements .......................................   9
  99.             
  100.             Limits .............................................  10
  101.             
  102.                Appendix A - File FIXing Primer .................  11
  103.             
  104.                Appendix B - Comparison FIX Configurations ......  12
  105.             
  106.                Appendix C - Complementary Batch Utilities ......  13
  107.             
  108.                                                
  109.                               DISCLAIMER OF WARRANTY
  110.                                                
  111.             THIS SOFTWARE AND MANUAL ARE OFFERED "AS IS" AND WITHOUT
  112.             WARRANTIES AS TO PERFORMANCE OR MERCHANTABILITY.  THE FIX
  113.             PROGRAM AND BATCH UTILITIES ARE SOLD WITHOUT ANY EXPRESS
  114.             OR IMPLIED WARRANTIES WHATSOEVER.  BECAUSE OF THE
  115.             DIVERSITY OF CONDITIONS AND HARDWARE UNDER WHICH THESE
  116.             PROGRAMS MAY BE USED, NO WARRANTY OF FITNESS FOR A
  117.             PARTICULAR PURPOSE IS OFFERED.  THE USER IS ADVISED TO
  118.             TEST THE PROGRAMS THOROUGHLY BEFORE RELYING ON THEM.  THE
  119.             USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAMS.
  120.             ANY LIABILITY OF LICENSOR/PUBLISHER OR AUTHOR WILL BE
  121.             LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF
  122.             THE PURCHASE PRICE.
  123.             
  124.            Copyright (C) 1993,1994 NovaLogic.  All rights reserved.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131. ::
  132.  
  133.             
  134.             
  135.             
  136.             
  137.                                Fix User's Manual          Page 1 of 13
  138.  
  139.  
  140.             
  141.            INTRODUCTION
  142.            ------------
  143.             FIX is a simple file maintenance utility that will find
  144.             and replace occurrences of any byte string in any size or
  145.             type of MS-DOS[1] file (see Appendix A).  Its virtues are
  146.             flexibility, speed, and built-in data protection.  There
  147.             are 3 configurations of FIX with progressively greater
  148.             functionality (see Appendix B):
  149.             
  150.              (1) FIX 4.02S, the SHAREWARE configuration, provides
  151.                  basic full function but includes a randomly appearing
  152.                  promotional screen;
  153.                  
  154.              (2) FIX 4.02R, the REGISTERED configuration, eliminates
  155.                  the promotional screen, supports 3 alternate modes of
  156.                  operation and delimited findstrings, and includes a
  157.                  larger set of complementary .BAT utilities (see
  158.                  Appendix C);
  159.                  
  160.              (3) FIX 4.02L, the LICENSED configuration, adds multifile
  161.                  capability by accepting the wildcards (?) and (*) in
  162.                  input and output filenames, and adds the ability to
  163.                  guarantee the replacestring is exclusive.
  164.                  
  165.             See the text file FIXLICEN.DOC for the license available
  166.             for each these configurations of FIX.  To register or
  167.             license FIX - print out and use the order form/mailer in
  168.             file FIXORDER.FRM.
  169.             
  170.             
  171.            USES FOR FIX
  172.            ------------
  173.             The most obvious use for FIX is changing the occurrences
  174.             of a misspelled or incorrect word in some body of text.
  175.             While this can be done with your editor or word processor,
  176.             it can be done more quickly using FIX if it's the only
  177.             change to be made.
  178.             
  179.             But FIX can do something that most editors or word proces-
  180.             sors can't, and that is make mass changes to non-printing
  181.             control characters.  This permits changing all single
  182.             spaced lines to double spaced in a large text file, or re-
  183.             formatting a large source code file by shifting all inden-
  184.             ted lines right, or left, by 1 tab.  For more examples see
  185.             ____________________
  186.                  [1] FIX is a trademark of NovaLogic.  NovaLogic is a
  187.             trademark of John F Crist.  MS-DOS and Windows are
  188.             trademarks of Microsoft Corp.  IBM-PC, PC-AT and PS/2 are
  189.             trademarks of IBM Corp.  8086, 8088, 80286, 80386, 80486 &
  190.             Pentium are trademarks of Intel Corp.
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197. ::
  198.  
  199.             
  200.             
  201.             
  202.             
  203.                                Fix User's Manual          Page 2 of 13
  204.  
  205.  
  206.             the included .BAT utilities.  FIX may also be used on
  207.             binary files to "patch" small portions of code or data.
  208.             
  209.             The power of FIX becomes more apparent in the LICENSED
  210.             configuration which enables the user to address a set of
  211.             files.  This makes it possible to correct a word which may
  212.             have occurred any number of times in each of the multiple
  213.             files which comprise some very large document.  Or you may
  214.             update the version and date information that appear in the
  215.             headers of a large set of source modules that make up a
  216.             computer program.  Judicious application of Licensed FIX
  217.             can save the user many keystrokes in maintaining a large
  218.             set of related files.
  219.             
  220.             
  221.            SYNTAX
  222.            ------
  223.            
  224.             FIX  [-c|-q|-f]  FINDSTRING  REPLACESTRING
  225.                                [d:][path]FILENAME  [d:][path][outfIle]
  226.             
  227.             The mandatory command line arguments are: (1) findstring,
  228.             (2) replacestring and (3) filename.  Optionally the user
  229.             may specify an output filename, and may also specify disk
  230.             drive(s) and directory path(s) for input and/or output
  231.             files.  FIX a